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Unit objectives 


¢ Manage parallel activity execution 


Explain how to implement a parallel task approval within a single 
process instance 


Manage messaging between processes 

Determine how to access data that is shared across multiple process 
activities 

Cancel a process at any time 

Determine when to use a multi-instance loop 

Explain how to implement multi-instance loops in IBM Business 
Automation Workflow 

Explain how to implement complex end conditions in a multi-instance 
loop 
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Process application interactions depend on comprehensive solutions to function correctly. 
Without an approach to implementing complex task and interactions, the business process 
becomes inefficient. This unit covers the methods that developers use to build effective complex 
tasks and interactions. 


There is also a hands-on lab exercise available to reinforce the concepts that are presented in 
this unit. After completing this unit, you should be able to: 

« Manage parallel activity execution 

« Implement a parallel task approval within a single process instance 

« Manage messaging between processes 

« Determine how to access data that is shared across multiple process activities 

« Cancel a process at any time 

« Explain how to implement multi-instance loops in IBM Business Automation Workflow 

« — Explain how to implement complex end conditions in a multi-instance loop 
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Topics 


° Parallel tasks and messaging 
° Multi-instance loops 
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Parallel tasks and messaging 


Managing complex tasks and process interactions © Copyright IBM Corporation 2016, 2018 
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Parallel tasks 


¢ An implementation requirement that has more than one process activity 
that is accomplished at any time 


¢ Four main points about parallel tasks: 
= Data flow 
= Sharing data among tasks 
= Variable number of tokens 
= Canceling parallel tasks 
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A common implementation requirement is to have more than one process activity that is 
accomplished at any time. Some interdependencies between these tasks might exist, so it is 
important to model your process to allow for both multi-participant task accomplishment and data 
sharing between each. 

When attempting to model and implement parallel tasks, consider the following topics: 

¢ Data flow 

¢ Sharing data among tasks 

¢ Variable number of tokens 

¢ Canceling parallel tasks 
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Data flow 


° With parallel tasks, output data flows out of both tasks 
= If you map the output variable for both tasks to the same complex business 
object, the task that completes last overwrites the data from all prior tasks 
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With parallel tasks, output data flows out of both tasks. If you write the output of both activities to 
the same output variable, the task that completes last overwrites the data from all prior tasks. 

To avoid this problem, do not map to the entire complex object; map to the business objects 
inside the larger object, and consider what data might be overwritten when mapping the outputs. 
You might also consider creating a custom object to hold the outputs of the parallel tasks. In 
certain cases, there might be some post-processing that is required to consolidate the input from 
the parallel activities to repopulate the original object. 


© Copyright IBM Corporation 2019 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


ZB828 Unit 11 Transcript 


Slide 7 


Sharing data among tasks 


° Tasks do not automatically share data, nor do they listen for messages 

° In many cases, it is necessary for parallel tasks to “see” what 
happened in other tasks, such as updated information or 
recommendations vital to the accomplishment of the task 
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In many cases parallel tasks must "see" what happened in other tasks, such as updated 
information or recommendations vital to the accomplishment of the task. Remember, the data that 
is mapped as an input variable is set when the process token arrives at the task. The data is not 
created when the user runs their task — it is set before that point. Tasks do not automatically 
share data, nor do they listen for messages about changed data. 
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How variables are passed (1 of 2) 


¢ When working with variables in IBM Business Automation Workflow, you 
must understand how variables are passed 

° Several factors determine whether variables pass by value or pass by 
reference, as described in the following table: 


From To Pass by 

Process Nested Value, if simple business object (variable 

activity process type) 

Process Nested Reference, if complex business object 

activity process (variable type) 

Process Service Value 

activity 

Service Nested Value, if simple business object (variable 
service type) 

Service Nested Reference, if complex business object 
service (variable type) 
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When creating your process, it is important to understand how data is passed between activities, 
between the process layer and the service layer, and between service-level steps. The table on 
this slide outlines how data is passed from one place to another inside of IBM Business 
Automation Workflow. 

All simple variables pass by value, which means a copy of the variable is made. Complex objects 
are passed either by value or by reference, which depends on where the data is being passed to. 
Passing by reference does not copy the entire complex object. 

Study this table, as it is critical to your understanding of passing objects inside of IBM Business 
Automation Workflow. 
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How variables are passed (2 of 2) 


° Changes in the referenced complex object values are reflected at a 
nested level 

° Pass by value creates a copy of the object, so changes are not 
reflected unless remapped back to the object 

¢ Always map complex variable inputs as outputs 


= Even though you can pass the variable by reference, mapping variables as 
outputs increases maintainability and clarity 
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If a variable is passed by value, the process or service that receives the value can manipulate it. 
The change does not affect the original value unless the receiving process step or service step 
returns the variable as an output, and is mapped back to that original variable. If a variable is 
passed by reference, the changes to the process or service variables that receive the reference 
affect the original value. These changes affect the variable even if the receiving process or 
service does not return the variable as an output. 

Because of the way IBM Business Automation Workflow handles variables, you should follow 
these guidelines: 

If the variable is a simple type, declare the variable as an input and an output in nested 
processes, services, and nested services. If the variable is a complex type, you must declare the 
variable as an input. Although the output declaration is not required (because complex types are 
passed by reference), it is a good idea to also declare the variable as an output. Creating the 
output variable ensures that other developers are aware that the nested process, service, or 
nested service returns a complex variable. 

Always use an identical name and data type for a set of input and output variables for data that is 
passed in, processed, and then passed back. 


© Copyright IBM Corporation 2019 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


ZB828 Unit 11 Transcript 


Slide 10 


Passing complex objects 
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This slide is a visualization of how complex objects are passed inside of IBM Business 


Automation Workflow. Complex objects are passed by reference if they remain in the same level. 


They are passed by value if the object is passed between levels. 

For example, a complex object is created at the highest level process. When the variable is 
mapped to a nested process, the object is passed by reference, so any changes made to the 
object in the nested process are reflected in the parent process. 

When an activity creates a task, the service creates a copy of the complex object and the values 
are passed to the service. Changes to this object are not reflected in the process unless the 
object is remapped to the parent object, or the object is designated as a shared object. 

When the service passes the complex object to a nested service, the object is passed by 
reference, so any changes made at the nested service level are immediately reflected at the 
parent service level. 
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Shared objects 


e Using the shared object check box on the business object General > 
Behavior properties section designates the variable as shared 
« The values of the complex object are persisted automatically to a data store 
» At each process, service, or message event boundary, the local variables 
with the same object key are refreshed from the data store 
= The save service is a data validation service that is started after updates to 
the shared business object are merged and before they are saved 


Y Behavior 


Definition type: Complex type Vv 
Shared object: 7) 


Save service: Shared Object Save Service x 


Managing complex tasks and process interactions © Copyright IBM Corporation 2016, 2018 


You can designate any complex object as shared. Shared business objects apply only to a 
complex structure type. The data within a shared business object is shared between business 
processes and tasks. You can send data from one process to a second process by using a 
message event or by using the unique key of the shared business object to load the data into the 
second process. 

When the object is shared, it is persisted to the workflow server database automatically, and can 
be manually persisted as well. At each process, service, or message event boundary, the local 
variables with the same object key as the shared object is refreshed from the data store. 

The Shared Object feature is best used for visibility - when you need data in two parallel tasks to 
be shared, it gives you a pass by reference object that you can manipulate at the service level. 
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Variable number of tokens 
° As tokens are created in the process, all tokens must run to the end to 
allow the process to complete 


° With parallel tasks, it is inevitable to have a variable number of tokens 
that flow through your process 


¢ Aconditional join might be necessary to consume all the tokens 
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As tokens are created in the process, all tokens must run to the end to allow the process to 
complete. When you have parallel tasks, it is inevitable that you will have a variable number of 
tokens that flow through your process. If there are any orphaned tokens in the process, you must 
provide a way to move that token to the end in order for the overall process to complete. 
Implementing a conditional join is one way to ensure that all tokens are consumed. 
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Canceling parallel tasks 


° The dynamics of a parallel task often allow for certain tasks to bring a 
process or the parallel tasks to a stop 
= The process requirements and implemented rules dictate how and when the 
process would be canceled or closed 
° To cancel a parallel task, consider how the cancellation affects all the 
process activities or tokens when: 
= Canceling and enclosing the process 


= Canceling only the parallel tasks in question with a unique ID (for example, 
Task ID) 


= Sending a cancel message 
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When implementing parallel tasks, it is a common requirement for the outcome of one of the 
tasks to cancel the other task, or to cancel the process instance entirely. For example, if a 
rejection in a parallel task causes the other approval step to be negated, you must be able to 
model that requirement. 
To cancel a parallel task, consider: 

e How the cancellation affects all the process activities or tokens when canceling and 

closing the overall process 
e Targeting one or many of the parallel tasks in question through a unique ID 
e Sending a cancel message to close all tokens in an instance 
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Messaging patterns 


° Message events are used to represent a point in your process where an 
incoming message is received 

° Processes listen for these messages, which can originate from multiple 
sources: 
= An internal web service message 
= Amessage posted to the JMS listener 
« Calling an undercover agent (UCA) in a service 

° These messages trigger events such as start or cancel a process 
= The message can trigger an event at the process or nested process level 
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Message listeners are an important component of your process design. They are used to 
represent a point in your process where an incoming message is received. Messages can trigger 
responses that are based on the message payload, and they are a key component to managing 
the process and data flow. 

You should realize that the message itself can originate from multiple sources at any time in your 
process. Whether it is an internal web service message, a message posted to the JMS listener, or 
calling an undercover agent in a service. The messages trigger events such as a start event ona 
process or an attached message event that would cancel a process. 
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Message events 


° The message start event functions as a start event based on a received 
message in your process 


° In contrast to the message start event, message intermediate events 
can be placed anywhere in the flow of your process 


° Message intermediate events are commonly used to: 
= Cancel a task 
= Restart a task 
= Update a process state 
= Cancel a process 
= Stop or resume the flow of a process 
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Message start events function as a start event based on a received message in a process. It can 
have input variables to the process. Intermediate events can be placed anywhere in a process, 
either attached to activities as an attached message intermediate event, or inline with the process 
flow as an inline intermediate message event. The inline message event pauses execution of the 
process to wait for the message event, the attached message event does not pause process 
execution. 


Message intermediate events are commonly used to: 
e Cancel a task 

Restart a task 

update a process state 

Cancel a process 

Stop or resume the flow of a process 
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Parallel tasks and messaging 


° All message intermediate events need a correlation ID 
= If you have parallel tasks, the process instance ID is not enough 


¢ Acommon scenario is a parallel task process where a rejection within 
one task requires the termination of all the other incomplete tasks 

° For a parallel task, you must implement a good pattern to accomplish 
the cancellation 


* Canceling a process at any time requires cleanup steps that might 
include a notification to process participants that the process is canceled 
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Often you encounter a requirement to cancel a task or even an entire process instance. Message 
intermediate events are useful for this purpose. 

In order to target the token or task you must cancel, you must have a unique identifier that tells 
the token that the message event is uniquely targeting it. The most common unique identifier that 
is used to target a token is the process instance ID. This unique identifier is effective when all 
tokens that are listening inside the same instance must react to the same message. If there are 
multiple tokens that must be uniquely targeted inside the same business process instance, the 
instance ID no longer is sufficient. 

When you create parallel process tasks, it is common for those tasks to influence each other. A 
common scenario is a parallel task process where a rejection within one task requires the 
termination of all the other incomplete tasks. You must implement a good pattern to accomplish 
the cancellation. Again, uniquely identifying and targeting the token is critical to this situation. 
Remember, canceling a process at any time might require cleanup steps that include a 
notification to process participants that the process is canceled. 
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Nested process cancellation pattern 


° To cancel a process, create a higher-level process and place the nested 
process on the canvas with a single attached message intermediate 
event 


¢ This approach replaces any terminate events that might be in the 
process, and allows elegant cleanup of tasks after the cancellation 
| Through user education, 
business users must 
aii understand that this high- 
ae ses level process is the 
cancellation pattern, and 
the implementation details 
are found in the nested 
process 
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To use this cancellation pattern, wrap your entire process in a nested process and attach a 
message intermediate event to listen for a cancellation at the highest level activity. This approach 
replaces any terminate events that might be in the process, and allows elegant cleanup of tasks 
after the cancellation. 


Using this design pattern, most of the process is not apparent to participants who view the 
process because the top-level process does not show all the details; it shows only the 
administrative cancellation implementation details. Through user education, business users must 
understand that the top-level process enables the cancellation pattern, and the implementation 
details are found in the nested process. 


Use the top-level process to start any new top-level process so the attached message listener 
has a token that is associated with it. Even if a cancellation is not part of the requirement, include 
this simple pattern for all processes because of its simplicity. This pattern allows developers to 
use a top-level cancellation if they encounter a situation where they might need this feature as 
they complete their process implementation. 
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Multi-instance loops 


Managing complex tasks and process interactions © Copyright IBM Corporation 2016, 2018 
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Multi-instance loops (MILs) 


° How do you model a loop when a 
variable number of tasks are 
needed at run time based on 


business data? nN 


¢ For what other scenarios would ’ 
you use a multi-instance loop? ‘4 
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You saw a pattern to handle parallel tasks in a process, but how do you model a loop when a 
variable number of tasks are needed at run time based on business data? This requirement can 
be fulfilled with a multi-instance loop. 
An example of a multi-instance loop implementation is a loan approval task where multiple 
signature authorities complete tasks in parallel or in sequence before a loan approval can be 
considered complete. Multi-instance loops create one token for each instance where simple loops 
create only one task for all instances. 


MIL stands for multi-instance loop throughout the rest of this unit. 
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Simple loop configuration 


¢ Simple loops: Tasks are created and performed serially 


Loop type: Simple loop ¥ 
Loop maximum: & 


Loop condition: 
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In a simple loop, the loop completes when all the tasks that are created complete the loop. The 
tasks are created one after the other — when the current task ends, the next task is created until 
all the tasks in the loop complete. Then the token flows down the sequence flow. 

The loop can implement many different types of artifacts to include subprocesses, linked 
processes, and simple activities. 
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Multi-instance loop configuration options 


¢ Multi-instance loops: Greater control over your instances 
° Ordering: Run sequentially or in parallel 


v Behavior 


- 


Loop type: Multi-instance loop ma 
v Multi-instance loop (a) 
Start quantity: fi & 
Ordering: Run in parallel v 
Flow condition: Conditional wait (Complex) v 


Complex flow condition: 


Cancel remaining instances: 
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If the loop requires a condition to determine whether the loop should continue, use a multi- 
instance loop type. A multi-instance loop gives you more control over the instances you create 
with the loop. The different types of multi-instance loops: 

e« Sequential: Each task is created after the last one completes 

¢ Parallel: All instances are created when the loop is created 
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Setting up a multi-instance loop (1 of 2) 


¢ The pattern for setting up a multi-instance loop: 
= Choose the loop type to be a multi-instance loop 
= This example sets the number of tasks created (start quantity) to the number 
of responses that are stored in a list (array) 
= Choose to run in parallel or serial 


v 


Loop type: Multi-instance loop 

Y  _Multi-instance loop @ 
Start quantity tw.local.responses listLength a 
Ordering: Run in parallel v 
Flow condition: Wait for all to finish (All) v 
Complex flow condition 1 


Cancel remaining instances: 
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Set up the multi-instance loop on the step tab of the activity. You can choose to run in parallel or 
run serially, but the true advantage to the multi-instance loop is realized when you run tasks in 


parallel. 
Create a start quantity. The example that is shown creates a token for each of the responses that 


are contained in the responses list object. 
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Setting up a multi-instance loop (2 of 2) 


° Assign a team filter for the lane participants 


Experts team [ Select |[ New 


¢ Sharing data with parallel tasks 
= Ifthe order of the output list must remain intact, use this pattern 


Y Output Mapping = 
responses (Respo... c> tw.local.responsesjtw.local. step] & 
step (integer) > tw.local.step & 


= Otherwise, use an initialized list variable without elements, and add to 
the end of the list 


Y Output Mapping Ss 
responses (Response) > tw.local responses|tw.local.responses .listLength] a 
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Many times, you'll be required to route your tasks to individual users instead of assigning tasks to 
a pool of users. This eliminates a situation where you might assign the tasks to a participant 
group, and it creates four tasks for the group. When members of the group login to the portal, 
they would see all four tasks in their inbox. 

Implement a team filter to route the tasks created by the MIL. Each task created by the MIL is 
filtered by the team filter service, and the filter must output only the user or users to assign the 
task. The team filter allows input variables to help create the resulting team. This is helpful, as 
you can utilize the step counter for the loop to target individuals for the tasks created. 

Set up your variables so they store the output correctly, and they do not overwrite one another. 
There are two common ways to map the output data. The first is to send into the activity the 
tw.system.step.counter variable as an input variable. When the step is sent out as an output, use 
the step as the array indexes for the variables you are trying to map to. Use this approach if the 
order of the output variable array must be maintained. 

The other approach is to use the list length and save the output to the end of the array, but this 
approach does not allow you to keep the order of the array intact. This approach provides only 
the order of activities that were completed as part of the loop. 
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Multi-instance loop end conditions 


¢ Use a multi-instance loop end condition when you want to specify what 
the multi-instance loop should do when an instance completes 
= For example, if you want the loop to terminate after one decision returns 
false, use a JavaScript condition to express this rule 


Start quantity: 
Ordering: 
Flow condition: 


Complex flow condition: 


Cancel remaining instances: 


Loop type: Multi-instance loop v 


YY Multi-instance loop @ 


tw.local.responses listLength & 


s 


Run in parallel 
Conditional wait (Complex) Vv 


1 !tw. local. responses[tw.local.step] .decisic 


> 
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The flow condition of the multi-instance loop is powerful. It is the only mechanism that makes it 
easy for you to examine the process state as soon as a parallel activity completes. You can then 
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determine whether to continue the remainder of those activities. 


The flow condition provides a simple way to create end conditions that are associated with 
parallel tasks. When the flow condition resolves to true, then the loop terminates and the token 
moves out of the multi-instance loop and down the flow. If you require the cancellation of all 


remaining tokens, check the Cancel Remaining Instances check box. 


Use this pattern when the outcome of one of the completed tasks in the multi-instance loop 


affects all of the other tasks that are not complete. 
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Multi-instance loops and performance 


° Never place a system activity as the first activity of a MIL 
= System lane activities lock an event manager engine thread until the activity 
is complete, so creating multiple instances of the loop can cause deadlock in 
the system until these activities complete 
= If possible, do the system lane activities that are required before the MIL 
¢ Multi-instance loops create N number of tokens since each nested 
process that is created gets a new token 
° Be wary of exit criteria: The MIL can create more tokens than what the 
process model can complete and thus cause a loop that never 
completes 


Managing complex tasks and process interactions © Copyright IBM Corporation 2016, 2018 


There are a few things to consider when you implement a multi-instance loop. The first activity 
should not be a system activity if you are enclosing a subprocess. Use a user task as the first 
activity of a nested process, and pull the system activity outside of the multi-instance loop, place it 
before the loop, and process all the tasks created for the loop in one system lane activity. 

Also, a multi-instance loop creates as many tokens as you have instances of the activity. It is 
possible to create so many tokens that the process would never complete. Thoroughly testing 
your multi-instance loops helps you avoid these common problems. 
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